Aviation API
27 Icing Charts
Icing forecast charts are produced from NZWRF (ECMWF) NZ 8km data based upon global weather model data produced by the ECMWF issuing centre. These charts are based on specific customer requirements.
The charts forecast out 30 hours from the analysis period (hour 0) of the model run, there are 30 charts produced per model run. If charts for a given analysis period are in the process of being generated then you may not receive a full list of 30 charts.
The charts are produced from the 00:00 and 12:00 model runs.
The charts present icing risk based on cloud thickness and temperature (cloud base above freezing level).
27.1 Latest Icing charts for a Region
Request the latest icing forecast analysis charts for the specified region produced from the specified global model. At this time the only region accepted is NZ (New Zealand).
27.1.1 API Call:
GET /aviation/v2/chart/icing/{region}/latest27.1.2 Path Parameters:
| Path Parameter | Example | Description |
|---|---|---|
| region | nz | A supported region code. The only supported region currently is 'nz'. This parameter is Mandatory. |
27.1.3 Example:
This example would return the latest icing charts for the NZ region.
GET /aviation/v2/chart/icing/nz/latest27.1.4 API Response:
{
"version": "1.0",
"issue-time": "2025-06-25T23:39:47Z",
"path": "/aviation/v2/chart/icing/nz/latest",
"response": [
{
"met:domain": "aviation",
"met:product-name": "chart",
"met:locator": "https://test-api.metservice.com/aviation/assets/chart/icing/nz/2025/06/25/12/202506251300.png",
"met:valid-at": "2025-06-25T13:00:00Z",
"met:analysis-time": "2025-06-25T12:00:00Z",
"met:prognosis-period": "001",
"met:region": "nz",
"av:chart-type": "icing",
"met:validity": "13"
},
{
"met:domain": "aviation",
"met:product-name": "chart",
"met:locator": "https://test-api.metservice.com/aviation/assets/chart/icing/nz/2025/06/25/12/202506251400.png",
"met:valid-at": "2025-06-25T14:00:00Z",
"met:analysis-time": "2025-06-25T12:00:00Z",
"met:prognosis-period": "002",
"met:region": "nz",
"av:chart-type": "icing",
"met:validity": "14"
},
.....example response truncated for illustration purposes
{
"met:domain": "aviation",
"met:product-name": "chart",
"met:locator": "https://test-api.metservice.com/aviation/assets/chart/icing/nz/2025/06/25/12/202506261700.png",
"met:valid-at": "2025-06-26T17:00:00Z",
"met:analysis-time": "2025-06-25T12:00:00Z",
"met:prognosis-period": "029",
"met:region": "nz",
"av:chart-type": "icing",
"met:validity": "17"
},
{
"met:domain": "aviation",
"met:product-name": "chart",
"met:locator": "https://test-api.metservice.com/aviation/assets/chart/icing/nz/2025/06/25/12/202506261800.png",
"met:valid-at": "2025-06-26T18:00:00Z",
"met:analysis-time": "2025-06-25T12:00:00Z",
"met:prognosis-period": "030",
"met:region": "nz",
"av:chart-type": "icing",
"met:validity": "18"
}
]
}27.2 Icing charts for given analysis period
Request the latest icing forecast analysis charts for the specified region and analysis period. At this time the only region accepted is NZ (New Zealand).
27.2.1 API Call:
GET /aviation/v2/chart/icing/{region}/{period}27.2.2 Path Parameters:
| Path Parameter | Example | Description |
|---|---|---|
| region | nz | A supported region code. The only supported region currently is 'nz'. This parameter is Mandatory. |
| period | 00 | A supported analysis period for the model run. Valid values: 00 and 12. This parameter is Mandatory. |
27.2.3 Example:
This example would return the icing forecast charts for the NZ region produced from 'ecmwf' global models latest 12:00Z model run.
GET /aviation/v2/chart/icing/nz/0027.2.4 API Response:
{
"version": "1.0",
"issue-time": "2025-06-25T23:54:02Z",
"path": "/aviation/v2/chart/icing/nz/00",
"response": [
{
"met:domain": "aviation",
"met:product-name": "chart",
"met:locator": "https://test-api.metservice.com/aviation/assets/chart/icing/nz/2025/06/25/00/202506250100.png",
"met:valid-at": "2025-06-25T01:00:00Z",
"met:analysis-time": "2025-06-25T00:00:00Z",
"met:prognosis-period": "001",
"met:region": "nz",
"av:chart-type": "icing",
"met:validity": "01"
},
{
"met:domain": "aviation",
"met:product-name": "chart",
"met:locator": "https://test-api.metservice.com/aviation/assets/chart/icing/nz/2025/06/25/00/202506250200.png",
"met:valid-at": "2025-06-25T02:00:00Z",
"met:analysis-time": "2025-06-25T00:00:00Z",
"met:prognosis-period": "002",
"met:region": "nz",
"av:chart-type": "icing",
"met:validity": "02"
},
.....example response truncated for illustration purposes
{
"met:domain": "aviation",
"met:product-name": "chart",
"met:locator": "https://test-api.metservice.com/aviation/assets/chart/icing/nz/2025/06/25/00/202506260500.png",
"met:valid-at": "2025-06-26T05:00:00Z",
"met:analysis-time": "2025-06-25T00:00:00Z",
"met:prognosis-period": "029",
"met:region": "nz",
"av:chart-type": "icing",
"met:validity": "05"
},
{
"met:domain": "aviation",
"met:product-name": "chart",
"met:locator": "https://test-api.metservice.com/aviation/assets/chart/icing/nz/2025/06/25/00/202506260600.png",
"met:valid-at": "2025-06-26T06:00:00Z",
"met:analysis-time": "2025-06-25T00:00:00Z",
"met:prognosis-period": "030",
"met:region": "nz",
"av:chart-type": "icing",
"met:validity": "06"
}
]
}